FileView by Snake River Software Version 1.4 Program and Documentation Copyright 1990-1992 All Rights Reserved Microsoft and MS-DOS are registered trademarks and Windows is a trademark of Microsoft Corporation. FileView 1.4 ______________________________________________________________________ Contents* Contents* Contents* 1. 1. 1. Overview Overview Overview ................................ ................................ ..................................... ..... ..... 1 1 1 2. 2. 2. Notations Notations Notations ................................ ................................ .................................... .... .... 1 1 1 3. 3. 3. Acknowledgements Acknowledgements Acknowledgements ............................. ............................. ............................. 1 1 1 4. 4. 4. System Requirements System Requirements System Requirements .......................... .......................... .......................... 1 1 1 5. 5. 5. Installation Installation Installation ................................ ................................ ................................. . . 2 2 2 6. 6. 6. Usage Usage Usage ................................ ................................ ........................................ ........ ........ 2 2 2 7. 7. 7. Commands Commands Commands ................................ ................................ ..................................... ..... ..... 3 3 3 8. 8. 8. Keys Keys Keys ................................ ................................ ......................................... ......... ......... 5 5 5 9. 9. 9. Searching Searching Searching ................................ ................................ .................................... .... .... 6 6 6 10. 10. 10. Messages Messages Messages ................................ ................................ ..................................... ..... ..... 7 7 7 11. 11. 11. WIN.INI WIN.INI WIN.INI ................................ ................................ ...................................... ...... ...... 8 8 8 12. 12. 12. License Information License Information License Information .......................... .......................... .......................... 9 9 9 13. 13. 13. Ordering Information Ordering Information Ordering Information ......................... ......................... ......................... 11 11 11 14. 14. 14. Rates Rates Rates ................................ ................................ ........................................ ........ ........ 10 10 10 A. A. A. Single User License Application Single User License Application Single User License Application .............. .............. .............. 12 12 12 B. B. B. Site License Application Site License Application Site License Application ..................... ..................... ..................... 13 13 13 * Page numbers are based on the printed version. The *.txt version of this document that is distributed on disk may not be the same. The page numbers should provide an approximate place to refer to. __________________________________________________________________________ Date: April 15, 1992 FileView 1.4 ______________________________________________________________________ 1. 1. 1. Overview Overview Overview This documentation is for release 1.4 of FileView. FileView is a Microsoft Windows based tool that allows you to browse files on your hard-drive or network drives. Unlike other Windows browsers, FileView does not load the file into memory, allowing you to browse files that are larger than available memory while leaving room for other windows applications to run. To use FileView, select a file to browse from the File/Open dialog as you would select a file in any other windows program. Once you are browsing a file, you can scroll through it and search for text using DOS style or Regular Expression style search patterns. 2. 2. 2. Notations Notations Notations The following notations are used in this manual: [text] is used to identify optional information. If the option is not specified, the default action will be taken. An exception is in the discussion of the WIN.INI file. WIN.INI section headers are identified as [text] [text] [text]. These sections are boldfaced to assist in their identification whereas [options] are not normally boldfaced. Hopefully, context and the use of boldfacing will distinguish these two uses. 3. 3. 3. Acknowledgements Acknowledgements Acknowledgements The regular expression routines were derived from routines written by Henry Spencer and copyright in 1986 by the University of Toronto. 4. 4. 4. System Requirements System Requirements System Requirements FileView runs within the Microsoft Windows. Minimum System requirements include: __________________________________________________________________________ Date: April 15, 1992 Page: 1 FileView 1.4 ______________________________________________________________________ Microsoft Windows 3.X or higher DOS 3.X or higher Approximately 80K memory* Approximately 80K disk space Windows compatible mouse * Memory available within the Windows environment. The memory required by FileView varies with use. The minimum memory is approximately 80K. 5. 5. 5. Installation Installation Installation FileView is easy to install. Simply copy all distribution files to the disk/directory where you want to run FileView from. This will usually be \windows. Note that you may install FileView in a directory that is not in your environment path if you provide the path to the program manager. However, the FileView.hlp file must be in the environment path for it be found when help is requested. If you install FileView in a path that is not in your environment path, installing it in the \windows directory is recommended. All configuration options reside in your WIN.INI file. All of these can be set within FileView. 6. 6. 6. Usage Usage Usage FileView is invoked like other windows programs. From the WINDOWS Program Manager, double click a Program Group that contains FileView, then double click on the FileView icon. If you have installed FileView as a program under Filefind's user defined menu, you may invoke it from Filefind and automatically open and browse the selected file. __________________________________________________________________________ Date: April 15, 1992 Page: 2 FileView 1.4 ______________________________________________________________________ 7. 7. 7. Commands Commands Commands _ F _ F _ File ile ile _ Open Invokes a dialog to choose a file to browse. The dialog consists of one edit field and two list boxes. The file name with a path or wild cards may be entered. If the file specification does not contain wild cards, FileView will attempt to open the file. If the file specification includes wild cards, FileView will list all matching files in the path, and change the default extension to match the specification extension. The extension will remain until changed again, or the program is terminated. A file list box allows a specific file to be picked without typing the filename. A directory list box allows the directory tree to be traversed and the disk drive to be changed. _ Refresh File Reloads the current file. FileView loads a series of pointers into the file the you are using. If this file becomes changed (because you are changing it with NOTEPAD for example), FileView will not display the file correctly. The _ Refresh File command instructs FileView to reload its pointers so the file is correctly displayed. This command is only needed if the file is changed while you are viewing it. _ Select Printer Selects the printer to use. The printer selected will remain the printer to use until another is selected or you close the program. If no printer is selected, the windows default printer is used. Setup... within this dialog opens the setup dialog for the particular printer selected. The details of the Setup... dialog vary with the printer selected. Control Panel... within this dialog will invoke the Control Panel(CONTROL.EXE CONTROL.EXE CONTROL.EXE). This program must reside in the windows directory (Whatever directory you originally installed windows in). _ Print File Prints the file. Print _ Window Prints the portion of the file shown by __________________________________________________________________________ Date: April 15, 1992 Page: 3 FileView 1.4 ______________________________________________________________________ the window. Select _ Font... Invokes a dialog that allows you to select a font and point size for printing the file or window. E_ xit Shuts down the program. _ E _ E _ Edit dit dit _ Search Invokes a dialog to specify search criteria _ Continue Search Searches from the top line in the display downward for the last search string specified. _ O _ O _ Options ptions ptions _ ASCII Switches the display mode to ASCII. ASCII is not always available. FileView examines the beginning of the file to determine whether ASCII mode is feasible. If not, ASCII mode is disabled. _ Hex Switches the display mode to Hexadecimal. _ Display Invokes a dialog that allows the display to be tailored. Settings in this dialog may be saved. Saved settings may also be restored. _ Other Controls auto-open, auto-refresh, initial sizing. Options can be saved or restored. _ Register User Invokes a dialog to enter a license id. _ H _ H _ Help elp elp Invokes the windows help program. Once invoked, you can select from the various help topics as in other windows 3.x programs. You can open other help files if you wish. When FileView is closed, the windows help program will also be closed (if no other application is using WinHelp). _ Index The main index is displayed _ Keys Displays help for FileView's use of keys. _ Printing Displays help about FileView printing. _ Refresh File Displays help about FileView file refreshing. __________________________________________________________________________ Date: April 15, 1992 Page: 4 FileView 1.4 ______________________________________________________________________ _ Searches Displays help about FileView text searching. A_ bout Invokes the About dialog. Additional information about the selected file is included in the About dialog. This information includes the file path, Size in bytes, size in records, date and time created or last modified, and the file attributes. __________________________________________________________________________ Date: April 15, 1992 Page: 5 FileView 1.4 ______________________________________________________________________ 8. 8. 8. Keys Keys Keys Ctrl+R Refresh the file => Scroll 1 character to the right <= Scroll 1 character to the left. /\ Scroll 1 character up \/ Scroll 1 character down Home Position at the top of the file Ctrl+Home Position at the leftmost position of the file End Position at the end of the file Ctrl+End Position at the rightmost position of the file PgUp Scrolls 1 screen up Ctrl+PgUp Scrolls 1 screen to the left PgDn Scrolls 1 screen down Ctrl+PgDn Scrolls 1 screen to the right F3 Repeat search forward Shift+F3 Invoke the Search specification Dialog. Alt+F4 Exit the application. Crtl+F12 Invoke the Open dialog. __________________________________________________________________________ Date: April 15, 1992 Page: 6 FileView 1.4 ______________________________________________________________________ 9. 9. 9. Searching Searching Searching FileView will the file for a specified string. To specify and start a search, invoke the Edit/Search Edit/Search Edit/Search command. Once the OK button is pressed, the search will start at the top of the file and continue until the string is found or the end of the file is encountered. FileView searches a single record at a time, so the search string can not span a line. Search For: Enter the text that should be search for. The string is entered as a wild card string or a regular expression depending on which search type is chosen. Ignore Case: If checked, the search ignores case in the search string and the file. If unchecked, the search matches on case as well as value for non- wildcard positions. Search Type Wildcard specifications are similar to wild card specification in DOS. Only the '?' is implemented as the '*' doesn't make a lot of sense. Regular Expression specifications include all the normal stuff. A couple brief commands for those not familiar with regular expressions: . Any character (like DOS ?) ? 0 or 1 of the previous character + 1 or more of the previous character * 0 or more of the previous character ^ match at the beginning of the line $ match at the end of the line [abc] match 'a', 'b', or 'c' Examples: a* match on 'a', 'aa', 'aaaaaaa', etc. a.b match on 'axb', 'ayb', 'azb', etc. a.b* match on 'ax', 'axb', 'axbb', 'ay', 'ab', 'abb' ^a.b matches 'axb' at the beginning of the line __________________________________________________________________________ Date: April 15, 1992 Page: 7 FileView 1.4 ______________________________________________________________________ a.b$ matches 'axb' at the end of the line Save Saves the current values of the Ignore Ignore Ignore Case Case Case check box and Search Search Search Type. Type. Type. Reset Reset Ignore Ignore Ignore Case Case Case check box and Search Search Search Type Type Type to the saved values. 10. 10. 10. Messages Messages Messages This section describes the various messages that FileView may generate. This section contains a description of the messages that are specific to FileView. Other messages may occur because of general windows errors, network problems, etc. Please refer to the appropriate documentation for these messages. File File File does not exist does not exist does not exist FileView can not open the requested file. This message will occur if you invoke FileView will a command line file that does not exist or specifies a path that does not exist. This message will also occur if you type in an invalid file or path from the open dialog. Not a valid license Id Not a valid license Id Not a valid license Id You have entered an invalid license id. You must provide a valid license id or cancel the dialog. Text Not Found Text Not Found Text Not Found You have invoked the Search... or Continue Search commands. FileView can not find a match for the search pattern. WM_COMMAND message nnnn not handled WM_COMMAND message nnnn not handled WM_COMMAND message nnnn not handled This message should never be displayed. If it does, an internal error has occurred. If you receive this message, please record the events leading to the message and contact support. __________________________________________________________________________ Date: April 15, 1992 Page: 8 FileView 1.4 ______________________________________________________________________ 11. 11. 11. WIN.INI WIN.INI WIN.INI This section describes the contents of the [FileView] section of the WIN.INI file. AOpn AOpn AOpn Indicates whether FileView automatically displays the open dialog when invoked. A value of 0 indicates that FileView will not not not automatically display the dialog. A value of 1 indicates that FileView will automatically display the dialog. ARef ARef ARef Indicates whether FileView automatically refreshes file. A value of 0 indicates that FileView will not not not automatically refreshes file. A value of 1 indicates that FileView will automatically refreshes file. IniX IniX IniX The initial horizontal size of FileView's window. iTab iTab iTab The initial vertical size of FileView's window. iTab iTab iTab The number of spaces that tab expansion creates. lLinN lLinN lLinN Indicates whether line numbers will be displayed or not. A value of 0 indicates that line numbers are not displayed. A value of 1 indicates that line numbers are displayed. lLinT lLinT lLinT Indicates whether line numbers or displacement values will be displayed. A value of 0 indicates that displacement values are displayed. A value of 1 indicates that line numbers are displayed. LnFt LnFt LnFt Indicates whether displayed line numbers are displayed as a decimal or hexadecimal number. A value of d indicates that line numbers are displayed as decimal numbers. A value of h indicates that line numbers are displayed as hexadecimal numbers. lRul lRul lRul Indicates whether a ruler will be displayed. A value of 0 indicates that a ruler will not be displayed. A value of 1 indicates that a ruler will be displayed. __________________________________________________________________________ Date: April 15, 1992 Page: 9 FileView 1.4 ______________________________________________________________________ lSrchC lSrchC lSrchC Indicates whether case is respected or ignored. A value of 0 indicates that case is respected. A value of 1 indicates that case is ignored. lSrchT lSrchT lSrchT Indicates whether wildcards or regular expressions are used. A value of 0 indicates that wild card expressions will be used. A value of 1 indicates that regular expressions will be used. lTab lTab lTab Indicates whether tabs in the file are expanded or not. A value of 0 indicates that tabs will not be expanded. A value of 1 indicates that tabs will be expanded. Regn=hhhhhhhhh Regn=hhhhhhhhh Regn=hhhhhhhhh Is used to store your license identifier. 12. 12. 12. License Information License Information License Information FileView is distributed as a shareware product. All rights have been reserved by the author. FileView has not been released into the public domain. If you use FileView beyond an initial evaluation period, you must purchase a license. Two license options are available. You may purchase one license for each user of FileView. Alternatively, you may purchase a site license. Duplication and Distribution Restrictions FileView is a shareware product. It may be copied and distributed for others to evaluate as long as the following rules are followed. They are: 1 The FileView program, this documentation, and any other accompanying materials may not be modified in any way. 2 A copy of this documentation and all accompanying materials must be distributed along with the program. 3 You may not charge for distributing this program, except for a nominal media and handling charge. In any case, such a charge may not exceed $10.00. __________________________________________________________________________ Date: April 15, 1992 Page: 10 FileView 1.4 ______________________________________________________________________ 4 Users of FileView must purchase a license for its use. One license per copy of FileView, or the alternative site license, is required. Note that this requirement allows you to make as many backup copies as you wish as long as you have a license per user or a site license. 5 If you purchased a disk containing this software from a public domain/shareware software distributor, you have paid the media and handling charges as permitted in 3 above. You have not purchased the required license for FileView. Purchasing a license is required for continued use. __________________________________________________________________________ Date: April 15, 1992 Page: 11 FileView 1.4 ______________________________________________________________________ 13. 13. 13. Ordering Information Ordering Information Ordering Information All orders for amounts less than two-hundred dollars ($200) must be pre-paid. Purchase orders for two-hundred dollars ($200) or more are subject to acceptance. Purchase orders that obligate the author to your company's terms and conditions are generally rejected. Purchase orders must include: l A list of items ordered with quantities l Shipping address l Billing address l The name, address, and phone number of a knowledgeable individual whom we may contact should any question about this order arise. All orders for single user licenses will normally receive a registration id for each registration ordered. All site licenses will normally receive a single registration id for each site license ordered regardless of the number of users in the license. Disks are usually supplied in 3 1/2 inch format in either 720K or 1.44M sizes at our discretion. If your needs differ from the above indicate your requirements on the order form. Variations from the above are not generally a problem. Printed documents or documents in electronic form other than the supplied .TXT format can be negotiated. Other requests or requirements will be reviewed on an individual basis. Two rate scales are available for licensing FileView. You may purchase a single user license or a site license. For either, you may simply purchase a license, or you may purchase a license and the current version on disk. Refer to the license applications following this section for current rates. The purchase of a license allows you to use FileView and receive support. As new versions are released, you may obtain them through the various shareware channels. New versions will also be available directly from the author for a nominal materials and shipping charge. FileView is registered by completing either the user or site application form and remitting the appropriate amount. We do not currently accept credit cards. Purchase Orders are accepted for site licenses only. __________________________________________________________________________ Date: April 15, 1992 Page: 12 FileView 1.4 ______________________________________________________________________ Make checks payable to and send payments to: William L. Page P.O. Box 266 Flagtown, New Jersey 08821-0266 Note Note Note Payments must be US funds. Checks must be drawn on or payable through a US bank. If you wish to remit a foreign check, we will attempt to have our bank process it through their collection department if you include a $7 fee. Somehow that doesn't seem worth it. Foreign users are probably better off sending cash. You can order the current version of the program when you register FileView. You should note the date of this document before ordering the current version. If the date is relatively recent, you probably have the most current version. If you have obtained FileView from a shareware distributor, it is probably six to twelve months and several versions old. When you register FileView, the registration acknowledgement will indicate the current version of the program. You have sixty days to order the current version at the same price at the price noted on the application. __________________________________________________________________________ Date: April 15, 1992 Page: 13 FileView 1.4 ______________________________________________________________________ Application for Single User License Registration FileView 1.4 Date: ______________________ To: William L. Page P.O. Box 266 Flagtown, New Jersey 08821-0266 Please register FileView for: Name___________________________________________________ (Company)______________________________________________ (Title)________________________________________________ Address________________________________________________ City, State Zip _____________________________________ Windows version that I am currently using: ____________ I got FileView from (BBS & Phone #) ___________________ _______________________________________________________ +--------------------------------+---------+-------+---------+ | Item | Unit $ | Quant | Total $ | +--------------------------------+---------+-------+---------+ | FileView | $10 | | | +--------------------------------+---------+-------+---------+ | Current Version on 3 1/2 disk | $6 | | | +--------------------------------+---------+-------+---------+ | Total | | +--------------------------------------------------+---------+ Special Requirements: __________________________________________ _________________________________________________________________ _________________________________________________________________ _________________________________________________________________ __________________________________________________________________________ Date: April 15, 1992 Page: 14 FileView 1.4 ______________________________________________________________________ Application for Site License Registration FileView 1.4 Date: ______________________ To: William L. Page P.O. Box 266 Flagtown, New Jersey 08821-0266 Please register FileView for: Name___________________________________________________ (Company)______________________________________________ (Title)________________________________________________ Address________________________________________________ City, State Zip________________________________________ I got FileView from (BBS & Phone #) ___________________ _______________________________________________________ +--------------------------------+---------+--------+--------+ | Item | Unit $ | Quant |Total $ | +--------------------------------+---------+--------+--------+ | First 10 Users | $100 | 1 | $100 | +--------------------------------+---------+--------+--------+ | Users 11-20 | $9 | | | +--------------------------------+---------+--------+--------+ | Users 21-50 | $8 | | | +--------------------------------+---------+--------+--------+ | Users 50+ | $7 | | | +--------------------------------+---------+--------+--------+ | Current Version on 3 1/2 disk | $12 | | | +--------------------------------+---------+--------+--------+ | Total | | +---------------------------------------------------+--------+ Special Requirements: __________________________________________ _________________________________________________________________ _________________________________________________________________ _________________________________________________________________ __________________________________________________________________________ Date: April 15, 1992 Page: 15